home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / fff46.zip / FFF.DOC < prev    next >
Text File  |  1994-05-18  |  66KB  |  1,480 lines
  1.  
  2.  
  3.                                    File Finder Pack
  4.                                      Version 4.6
  5.                                        05-18-94
  6.                                           by
  7.                                        Jim Derr
  8.  
  9.                                       Member of
  10.                         Association of Shareware Professionals
  11.                                  CSERVE ID 76266,2634
  12.  
  13.  
  14.  
  15.         HARDWARE SOFTWARE REQUIREMENTS  . . . . . . . . . . . . . . . . . .  3
  16.  
  17.  
  18.         QUICK START . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  19.  
  20.  
  21.         PERFORMING A FUZZY SEARCH . . . . . . . . . . . . . . . . . . . . .  4
  22.  
  23.  
  24.         CONFIGURING THE FFF.EXE ,FFD.EXE, and FF2.COM PROGRAMS  . . . . . .  5
  25.  
  26.  
  27.         MEMORY USAGE IN THE FFF.EXE PROGRAM . . . . . . . . . . . . . . . .  6
  28.  
  29.  
  30.         FF2 PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  31.  
  32.  
  33.         FFF PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  34.  
  35.  
  36.         FFF HOT KEYS  . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  37.  
  38.  
  39.         MODIFYING THE FFF FILE LISTING FORMAT . . . . . . . . . . . . . . . 20
  40.  
  41.  
  42.         MODIFYING THE FFF PRINT FORMAT  . . . . . . . . . . . . . . . . . . 21
  43.  
  44.  
  45.         FFD PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  46.  
  47.  
  48.         SMART LAUNCH FEATURE  . . . . . . . . . . . . . . . . . . . . . . . 25
  49.  
  50.  
  51.         MEMORY SWAPPING OPTION IN FFF . . . . . . . . . . . . . . . . . . . 25
  52.  
  53.  
  54.         MONOCHROME MONITORS . . . . . . . . . . . . . . . . . . . . . . . . 25
  55.  
  56.  
  57.         MISC. INFORMATION . . . . . . . . . . . . . . . . . . . . . . . . . 25
  58.  
  59.  
  60.         THE SGREP PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . 27
  61.  
  62.  
  63.         REGULAR EXPRESSIONS . . . . . . . . . . . . . . . . . . . . . . . . 29
  64.  
  65.  
  66.         REVISION HISTORY  . . . . . . . . . . . . . . . . . . . . . . . . . 30
  67.  
  68.  
  69.         INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
  70.  
  71.  
  72.                           FileFinder Version 4.5 User Manual           Page-3-
  73.  
  74.         This  is a  shareware product.    If you  find these  utilities useful
  75.         please register and keep shareware alive.   Only registered users will
  76.         be supported..
  77.  
  78.                             HARDWARE SOFTWARE REQUIREMENTS
  79.  
  80.         FF2, FFF, and FFD can  be run on any DOS  based PC having a CGA,  MDA,
  81.         EGA, VGA, or HERC monitor.
  82.         The DOS  operating system must be  3.1 or greater.   Both program will
  83.         also operate correctly  in the DOS  compatibility box  of OS/2 1.2  or
  84.         greater.  Token ring networks or Novell networks are also supported.
  85.         DOS memory  requirements range from a  low of 160K  to a high  of 400K
  86.         depending on how the FFF program is configured.
  87.  
  88.                                      QUICK START
  89.         The  FF2 program  performs file  search operations  and will  show the
  90.         results on the screen or the output can be redirected to a file.
  91.  
  92.         The  FFF program performs file search  operations and will display the
  93.         results on the screen in a scrollable window.  Numerous operations can
  94.         then be performed on user selected files.
  95.  
  96.         The FFD program performs directory search operations and  will display
  97.         the results on the screen in a scrollable window.
  98.  
  99.         FF2, FFF, and  FFD use basically the same format  for the command line
  100.         option.  All command line  parameters MUST be separated by  blanks and
  101.         all options MUST begin with a forward slash /.  The options may appear
  102.         anywhere  on  the command line.   The format  of the command  line for
  103.         both programs is:
  104.  
  105.         FFx [options]  [[drives:] [filespec]] [options]
  106.  
  107.         If the drives  parameter is omitted the programs will  search all hard
  108.         drives that can  be identified.  If  the drives parameter is  included
  109.         then  only the  drives specified  will be  searched. (PLEASE  NOTE THE
  110.         COLON MUST BE ENTERED AFTER THE DRIVE LETTERS).
  111.  
  112.  
  113.  
  114.                           FileFinder Version 4.5 User Manual           Page-4-
  115.  
  116.  
  117.                               PERFORMING A FUZZY SEARCH
  118.  
  119.         Both FF2 and FFF  can also perform a fuzzy search.   This is useful if
  120.         you are trying  to locate a  file but don't  know the exact  filename.
  121.         The  fuzzy search routine will attempt to locate files that sound like
  122.         the filename entered on the command line.  To indicate that you want a
  123.         fuzzy search performed place the ~ character in front of the filename.
  124.         PLEASE NOTE: WHEN  PERFORMING A  FUZZY SEARCH  DO NOT  INCLUDE A  FILE
  125.         EXTENSION.  See the examples below.
  126.  
  127.         If the colon is entered without any drive letter preceding it then FFF
  128.         and FF2 will only search for files on the current default disk drive.
  129.  
  130.         For example:
  131.  
  132.         FFF : *.bat
  133.  
  134.         This will  search for all files on the current default drive that have
  135.         a file extension of bat.
  136.  
  137.         Multiple  filespecs may be  entered along  with multiple drives.   For
  138.         example:
  139.  
  140.         FF2  *.BAK CD: \UTILITY\*.COM  DE: \TEMP\*.*  C:\JIM\*.*
  141.  
  142.         This example will:
  143.         1)   Find all  files that have a file extension of BAK that resides on
  144.              any identifiable hard drive.
  145.  
  146.         2)   Find all files that have  a file extension of COM in  the UTILITY
  147.              directory  or any sub-directory of  the UTILITY directory ONLY ON
  148.              HARD DRIVES C AND D.
  149.  
  150.         3)   Find all  files that  reside in  the TEMP  directory or any  sub-
  151.              directory of the TEMP directory ONLY ON HARD DRIVES D AND E.
  152.  
  153.         4)   Find all  files that  reside  in the  JIM directory  or any  sub-
  154.              directory of the JIM directory ONLY ON THE C DRIVE.
  155.  
  156.         FFF  ~QRT
  157.  
  158.         Perform a  fuzzy search looking for  all files that sound  like qtr on
  159.         all drives.
  160.  
  161.         FFF  ~QTR  *.COM
  162.  
  163.         Perform  the same fuzzy  search as above, in  addition locate all .COM
  164.         files.
  165.  
  166.         Any options that appear on the  command line are active for all search
  167.         operations.
  168.  
  169.  
  170.                           FileFinder Version 4.5 User Manual           Page-5-
  171.  
  172.                 CONFIGURING THE FFF.EXE ,FFD.EXE, and FF2.COM PROGRAMS
  173.  
  174.         The FF series  of   programs have numerous  configurable options.   To
  175.         configure the programs  the configuration program  FFFCFG.EXE must  be
  176.         run.  Simply enter FFFCFG at the DOS command prompt and the answer the
  177.         questions as  they appear.  The FFFCFG  program will create an FFF.CFG
  178.         file that  is used by  all FF programs.   THE  FFF.CFG FILE SHOULD  BE
  179.         MOVED INTO A DIRECTORY THAT IS LOCATED IN YOUR DOS PATH.
  180.  
  181.         When the CTRL-ENTER keys are pressed FFF can execute a user defined
  182.         program against the currently highlighted file based on the file
  183.         extension.  Up to THREE sets of file extensions and program names
  184.         can be defined.
  185.  
  186.         When prompted for an extension list enter the file extensions you wish
  187.         to operate on, each extension MUST have a period preceding the
  188.         extension, i.e.  EXT1=.ZIP.LZH.ZOO
  189.  
  190.         When prompted for the program to execute, please include the full path
  191.         and  use the ! character to indicate where to substitute the filename,
  192.         i.e.  PGM1=C:UTILITYSHEZ.EXE !
  193.  
  194.  
  195.                           FileFinder Version 4.5 User Manual           Page-6-
  196.  
  197.                          MEMORY USAGE IN THE FFF.EXE PROGRAM
  198.  
  199.         The  FFFCFG program now allows you set  the number of files and unique
  200.         directories that  the FFF program can  handle.  The FFF  program comes
  201.         pre-configured  to handle 3000  files and 300  unique directory names.
  202.         Under this configuration  the FFF program  uses approximately  317,000
  203.         bytes of memory.  If you increase or decrease the  number of files FFF
  204.         can handle it's  memory usage increases or  decreases by 49  bytes for
  205.         each additional file you tell FFF to handle.
  206.  
  207.  
  208.         If you increase  or decrease the number of  unique directory names FFF
  209.         can handle its memory usage increases or decreases by 70 bytes.
  210.  
  211.  
  212.         To  determine the amount  of memory FFF  will need,  use the following
  213.         formula:
  214.  
  215.              149300 + (49 * number of files  to handle) + (70 * number of dirs
  216.              to handle)
  217.  
  218.  
  219.         For example, the memory requirements for FFF to handle 5000 files  and
  220.         400 unique directories would be:
  221.  
  222.              149300 + (49 * 5000) + (70 * 400) = 422,300
  223.  
  224.         The FFF program will automatically use EMS memory if it  is available.
  225.         EMS  memory will be  used to store  directory information thus freeing
  226.         conventional memory allowing FFF to handle more file names.
  227.  
  228.  
  229.  
  230.                           FileFinder Version 4.5 User Manual           Page-7-
  231.  
  232.                                      FF2 PROGRAM
  233.         This program will find files on your hard disk.  It as fashioned after
  234.         the whereis program but has more features.
  235.  
  236.         Format is:
  237.  
  238.         FF2 [options] [[drives:] [filespec]] [options]
  239.  
  240.         Where options are:
  241.         /C        comma delimited listing
  242.         /R        raw listing - full path name only
  243.         /S        short listing - filename.ext only
  244.         /B        list in bat file format
  245.         /P        pause when screen is full
  246.         /Q        quite mode
  247.         /I        also look inside archive files
  248.         /A        only look inside archive files
  249.         /G        Greater or Equal to mm-dd-yy
  250.         /L        Less or Equal to mm-dd-yy
  251.         /=        Equal to mm-dd-yy
  252.         /SD       Single Directory search only (do not recurse)
  253.         /1        stop after finding one file
  254.                   errorlevel 1 returned if no files found
  255.                   errorlevel 0 returned if files are found
  256.         /Z[RHSA]  Show files with specified attributes
  257.         /X"cmd"   execute a cmd against all files found
  258.         /@        Prompt for options.
  259.         /NN       No-Network drive search
  260.         /LN       Look for network drives
  261.         /!        Exclude files that match specified pattern
  262.         /w        Find  files that were created or  modified on a specific day
  263.                   of the week.
  264.         /t        Find files that contain a specified text string.
  265.         /F        Create a fixed format listing
  266.         /SL       Find files with size less than or equal to x.
  267.         /SG       Find files with size greater than or equal to x.
  268.         /D        Display compressed filenames being searched.
  269.  
  270.         The filespec's that are  specified on the command  line can include  a
  271.         disk  and directory. If a disk and  or directory is specified than the
  272.         search  will be restricted to the specified disk and directory and any
  273.         sub-directories under  the specified  directory.   Each  filespec  can
  274.         contain different starting disks and directories.
  275.  
  276.         When  specifying the  file  to search  for FF2  has  a quick  complete
  277.         algorithm.  If you do not include a period in the file ex   tension
  278.         FF2 will  expand the filespec  using the wildcard character  ? for the
  279.         remainder  of the filespec.   For example  if you entered  FF2 AB, FF2
  280.         will expand the filespec to  AB??????.???.  If you enter  FF2 C:\BAT\B
  281.         FF2  will expand the filespec to  C:\BAT\B???????.???.  However if you
  282.         enter FF2 B.* ,  FF2 will not alter the filespec  since you included a
  283.         period in the filespec.
  284.  
  285.         FF2 also has an expanded wild card search algorithm. If you include an
  286.         * on  both sides of  the filename,  FF2 will find  all files  that
  287.         contain  the characters  entered  between  the  *'s  anywhere  in  the
  288.         filename. For example:
  289.  
  290.         FF2 *inst*
  291.  
  292.  
  293.  
  294.                           FileFinder Version 4.5 User Manual           Page-8-
  295.  
  296.         This will find all files that contain inst somewhere in the filename.
  297.  
  298.         I.E. D:\ANY\PINST.BAT
  299.              C:\ONE\PCINSTAL.BAT
  300.              C:\TWO\INSTALL.COM
  301.  
  302.         To find  files  with  no extension  include  the period  but  no  file
  303.         extension. I.E.  FF2 *me*.
  304.  
  305.         If no  disk or directory is  included with the filespec  than all hard
  306.         disks will be searched.
  307.  
  308.  
  309.                           FileFinder Version 4.5 User Manual           Page-9-
  310.  
  311.         FF2 now has the capability to automatically identify all hard disks on
  312.         your  system.  You  can over-ride this  automatic detection by setting
  313.         the environment variable FF to the disk letter your wish the search to
  314.         be performed on. For example.  SET FF=CD tells FF2 to search the C and
  315.         D drives if  you have  not specified  a disk  in the  filespec on  the
  316.         command line.
  317.  
  318.         All  output  from FF2  can be  redirected or  piped  by using  the DOS
  319.         redirect and pipe characters.
  320.  
  321.         The default output  produced by FF2  file-size, file-date,  file-time,
  322.         disk:\directory\filename.file-ext. This  can be  changed by  using the
  323.         following command line options:
  324.  
  325.         /C   Produces a comma  delimited listing, this listing can be imported
  326.              into most spreadsheet and database programs.
  327.  
  328.         /R   Produces a raw listing containing disk:\directory\fn.ext only.
  329.  
  330.         /S   Produces a short listing containing filename.ext only.
  331.  
  332.         /B   Produces a  listing that can be used as a bat file. The output is
  333.              as follows:
  334.              %1 filename.ext %2 %3 %4 %5 %6 %7 %8 %9
  335.  
  336.         /P   Will case a pause when the screen is full.
  337.  
  338.         /Q   Quite mode no output produced but results can be tested  by using
  339.              the if errorlevel command in a .bat file.
  340.  
  341.         /I   This option tells  FF2 to also look inside any  archive files for
  342.              the  indicated files.   The archive files  that are supported are
  343.              ZIP, ARC, ARJ, ZOO, PAK, LZH and SQZ files.
  344.  
  345.         /A   This option tells FF2 to  ONLY look inside archive files  for the
  346.              indicated files.
  347.  
  348.         /1   This  option tells FF2  to stop looking for  files after it finds
  349.              the first file that matches the specified pattern.
  350.  
  351.         /G   This option  allows you  to limit the  file search to  files that
  352.              have a filedate Greater than or  Equal to the date specified. The
  353.              format is /Gmm-dd-yy.
  354.              I.E.  /G01-01-90   or   /G1-1-90  will  list  files that  have  a
  355.              filedate greater than or equal to 1-1-90.
  356.              (Note this option may be combined with the /L option to specify a
  357.              date range)
  358.  
  359.         /L   This  option allows you  to limit the  file search  to files that
  360.              have a filedate  Less than or  Equal to the  date specified.  The
  361.              format is /Lmm-dd-yy.
  362.              I.E.  /L01-01-90   or    /L1-1-90  will list  files  that have  a
  363.              filedate less than or equal to 1-1-90.
  364.              (Note this option may be combined with the /G option to specify a
  365.              date range)
  366.  
  367.         /=   This  option allows  you to limit  the file search  to files that
  368.              have a filedate Equal  to the date specified. The format is /=mm-
  369.              dd-yy.
  370.  
  371.  
  372.  
  373.                           FileFinder Version 4.5 User Manual          Page-10-
  374.  
  375.              I.E.  /=01-01-90    or   /=1-1-90  will list  files  that  have a
  376.              filedate to 1-1-90.
  377.  
  378.         /Z[RHSA]
  379.              This  option allows you  to limit the  file search  to files that
  380.              have specific attributes.   For example, specifying /ZA will list
  381.              files that have the archive attribute, /ZRH  will list files that
  382.              have the read-only attribute OR the hidden attribute set.
  383.              ***PLEASE NOTE  IF YOU  SPECIFY THE  /A OR  /I OPTIONS  THAN THIS
  384.              OPTION IS IGNORED***
  385.  
  386.         /SD  This  option informs FF2  to only  search the directory  that was
  387.              specified on the command line  and not to search any  directories
  388.              that exist under the specified directory.
  389.  
  390.  
  391.  
  392.                           FileFinder Version 4.5 User Manual          Page-11-
  393.  
  394.         /X"cmd"
  395.              This options  allows  you to  tell  FF2  to execute  a  specified
  396.              against all files that are found.
  397.              For Example:
  398.  
  399.              /X"del &"
  400.  
  401.              will execute the delete command against all file that were found.
  402.              The command can be any DOS command or another program.   FF2 will
  403.              insert the disk:\dir\fn.fext of  the found file into the  command
  404.              where you place the & character.
  405.  
  406.              For example if you specify the following:
  407.  
  408.              /X"grep any & -s"
  409.  
  410.              and  FF2  finds  the  file c:\data\any.doc  it  will  execute the
  411.              following command:
  412.  
  413.              grep any c:\data\any.doc -s
  414.  
  415.              If  you do  not  put the  & in  then  FF2 will  insert the  found
  416.              filespec at the first blank in the command you specify, or at the
  417.              end of the command if no blanks exist.
  418.  
  419.         /@   This  options instructs FF2  to prompt  the user for  the command
  420.              line parameters.  PLEASE NOTE NO OTHER PARAMETERS  ARE ALLOWED ON
  421.              THE COMMAND  LINE IF THIS OPTION  IS SPECIFIED.  The  use of this
  422.              option  also allows the user  to use the  DOS redirect feature to
  423.              feed FF2 it's parameters.
  424.  
  425.              For example:  FF2 /@ < FF2.DAT
  426.  
  427.              This  instructs FF2 to  read its  parameters from the  file names
  428.         FF2.DAT.
  429.  
  430.         /NN  This option allows you to bypass the searching of Network drives.
  431.              If  you configured FF2  to search for network  drives you may use
  432.              this option to temporarily bypass the network drive search.
  433.  
  434.         /LN  This option  allow you to search for files on Network drives.  If
  435.              you  configured FF2  to ignore  network drives  you may  use this
  436.              options to temporarily look for files on any networked drives.
  437.  
  438.         /!   This  option allows you  to exclude  files. Files that  match the
  439.              excluded  file pattern  will not be  listed.  For  example if you
  440.              entered the following command:
  441.              FF2  *.c /!f*.c
  442.              This would list all the files with a .C file extension EXCEPT for
  443.              files that begin with the  letter F and have a file  extension of
  444.              .C.
  445.  
  446.         /Wx  This option allows you to search for files that were created on a
  447.              specific day of the week. Replace the x with a digit in the range
  448.              of 0-6 where 0=Sunday, 1=Monday, 2=Tuesday, etc.
  449.  
  450.         /Tx  This option allows you to  find files that contain specific  text
  451.              strings.  Replace  the x with the text string  you wish to search
  452.              for.  For example, to  find all files that contain the  word TIME
  453.  
  454.  
  455.  
  456.                           FileFinder Version 4.5 User Manual          Page-12-
  457.  
  458.              use the code the parameter as follows:
  459.              /Ttime
  460.              If the word or phrase you wish to search for  has embedded spaces
  461.              you MUST ENCLOSE THE ENTIRE PARAMETER IN QUOTES.  For example, to
  462.              find all files that contain  the phrase NOW IS THE TIME  code the
  463.              parameter as follows:
  464.              "/Tnow is the time"
  465.  
  466.         /F   The F option will produce a  fixed format listing of found files.
  467.              This listing can be input to a sort program if needed.
  468.  
  469.         /D   The D option will display the compressed  files that FF2 searches
  470.              through.   This  can  be helpful  for finding  damaged compressed
  471.              files.
  472.  
  473.  
  474.         /SLx The SL  option allows you to find files that have file sizes Less
  475.         than or Equal to x.  Where x is the number of bytes.
  476.  
  477.         /SGx The  SG option  allows you  to find  files that  have file  sizes
  478.              Greater than or Equal to x.  When x is the number of bytes.
  479.  
  480.  
  481.                           FileFinder Version 4.5 User Manual          Page-13-
  482.  
  483.                                      FFF PROGRAM
  484.  
  485.         This  program will find files on your hard disk, and present them in a
  486.         scrollable list.
  487.  
  488.         Format is FFF [options] [[drives:] [filespec]] [options]
  489.  
  490.         Where options are:
  491.         /2   25 line mode display
  492.         /4   43 line mode display
  493.         /5   50 line mode display
  494.         /d   Search for dup files. (filename.ext only)
  495.         /D   Search for dup files. (filename.ext and file size)
  496.         /G   Greater or Equal to mm-dd-yy
  497.         /=   Equal to mm-dd-yy
  498.         /L   Less or Equal to mm-dd-yy
  499.         /I   also look inside archive files
  500.         /A   only look inside archive files
  501.              (THE  ARCHIVE FILES THAT  ARE SUPPORTED  ARE ZIP,ARC,ARJ,PAK,LZH,
  502.              and SQZ)
  503.         /Z[RHSA]
  504.              Show files with specified attributes
  505.         /SD  Single Directory search only (do not recurse)
  506.         /NN  No-Network drive search
  507.         /LN  Look for network drives
  508.         /@   Prompt for options.
  509.         /!   Exclude files that match specified pattern.
  510.         /w   Find files that were created or modified on a specific day of the
  511.              week.
  512.         /t   Find files that contain a specified text string.
  513.  
  514.         /I   This option tells FFF  to also look inside any  archive files for
  515.              the indicated files.   The archive files  that are supported  are
  516.              ZIP, ARC, ARJ, ZOO, PAK, LZH, and SQZ files.
  517.  
  518.         /A   This  option tells FFF to ONLY  look inside archive files for the
  519.              indicated files.
  520.  
  521.         /d   This option tells FFF to search and display duplicate files. Only
  522.              the filename.ext will be used to determine duplicates.
  523.  
  524.         /D   This option is the same as the /d option except  the filename.ext
  525.              and file size will be used to determine if a file is a dup.
  526.  
  527.         /G   This option  allows you to  limit the  file search to  files that
  528.              have a filedate Greater than or Equal  to the date specified. The
  529.              format is /Gmm-dd-yy.
  530.              I.E.  /G01-01-90    or   /G1-1-90  will list  files  that  have a
  531.         filedate greater than or equal to 1-1-90.
  532.              (Note this option may be combined with the /L option to specify a
  533.         date range)
  534.  
  535.         /L   This option allows  you to limit  the file search  to files  that
  536.              have a  filedate Less than  or Equal to  the date specified.  The
  537.              format is /Lmm-dd-yy.
  538.              I.E.  /L01-01-90   or    /L1-1-90 will  list  files  that have  a
  539.              filedate less than or equal to 1-1-90.
  540.              (Note this option may be combined with the /G option to specify a
  541.         date range)
  542.  
  543.  
  544.  
  545.                           FileFinder Version 4.5 User Manual          Page-14-
  546.  
  547.         /=   This  option allows you  to limit the  file search to  files that
  548.              have a  filedate Equal to the date specified. The format is /=mm-
  549.              dd-yy.
  550.              I.E.  /=01-01-90   or    /=1-1-90 will  list  files  that have  a
  551.              filedate to 1-1-90.
  552.  
  553.         /SD  This  option informs FF2  to only  search the directory  that was
  554.              specified on the command line  and not to search any  directories
  555.              that exist under the specified directory.
  556.  
  557.  
  558.  
  559.                           FileFinder Version 4.5 User Manual          Page-15-
  560.  
  561.         /Z[RHSA]
  562.              This  option allows  you to limit  the file search  to files that
  563.              have specific attributes.  For example,  specifying /ZA will list
  564.              files that have the archive attribute, /ZRH  will list files that
  565.              have the read-only attribute OR the hidden attribute set.
  566.              **PLEASE NOTE IF YOU SPECIFY THE /A OR /I OPTION THAN THIS OPTION
  567.              IS IGNORED.**
  568.  
  569.         /NN  This option allows you to bypass the searching of Network drives.
  570.              If you configured  FF2 to search for  network drives you may  use
  571.              this option to temporarily bypass the network drive search.
  572.  
  573.         /LN  This option allow you to search  for files on Network drives.  If
  574.              you  configured FF2  to ignore  network drives  you may  use this
  575.              options to temporarily look for files on any networked drives.
  576.  
  577.         /!   This  option allows you  to exclude  files. Files that  match the
  578.              excluded file  pattern will not  be listed.   For example if  you
  579.              entered the following command:
  580.              FF2  *.c /!f*.c
  581.              This would list all the files with a .C file extension EXCEPT for
  582.              files that begin  with the letter F and have  a file extension of
  583.              .C.
  584.  
  585.         /Wx  This option allows you to search for files that were created on a
  586.              specific day of the week. Replace the x with a digit in the range
  587.              of 0-6 where 0=Sunday, 1=Monday, 2=Tuesday, etc.
  588.  
  589.         /Tx  This option allows you to  find files that contain specific  text
  590.              strings.   Replace the x with the  text string you wish to search
  591.              for.  For  example, to find all files that  contain the word TIME
  592.              use the code the parameter as follows:
  593.              /Ttime
  594.              If the word or phrase you  wish to search for has embedded spaces
  595.              you MUST ENCLOSE THE ENTIRE PARAMETER IN QUOTES.  For example, to
  596.              find  all files that contain the phrase  NOW IS THE TIME code the
  597.              parameter as follows:
  598.              "/Tnow is the time"
  599.  
  600.  
  601.         /@   This  options instructs FFF  to prompt  the user for  the command
  602.              line  parameters. PLEASE NOTE NO  OTHER PARAMETERS ARE ALLOWED ON
  603.              THE COMMAND  LINE IF THIS OPTION  IS SPECIFIED.  The  use of this
  604.              option also  allows the user  to use the DOS  redirect feature to
  605.              feed FF2 it's parameters.
  606.  
  607.              For example:  FFF /@ < FFF.DAT
  608.  
  609.              This  instructs FFF to  read its  parameters from the  file names
  610.         FFF.DAT.
  611.  
  612.         /SLx The SL option allows you to  find files that have file sizes Less
  613.         than or Equal to x.  Where x is the number of bytes.
  614.  
  615.         /SGx The  SG option  allows  you to  find files  that have  file sizes
  616.              Greater than or Equal to x.  When x is the number of bytes.
  617.  
  618.  
  619.                           FileFinder Version 4.5 User Manual          Page-16-
  620.  
  621.         The filespec's that are  specified on the  command line can include  a
  622.         disk and directory. If a  disk and or directory is specified  than the
  623.         search will be restricted  to the specified disk and directory and any
  624.         sub-directories under  the specified  directory.   Each  filespec  can
  625.         contain different starting disks and directories.
  626.  
  627.         When  specifying the  file  to search  for  FFF has  a  quick complete
  628.         algorithm.  If you do not include a period and  the file extension FFF
  629.         will expand  the  filespec using  the  wildcard  character ?  for  the
  630.         remainder of  the filespec.   For example if  you entered FFF  AB, FFF
  631.         will  expand the filespec to AB??????.???.   If you enter FFF C:\BAT\B
  632.         FFF will expand the filespec  to C:\BAT\B???????.???.  However if  you
  633.         enter FFF B.* , FFF will  not alter the filespec since you  included a
  634.         period in the filespec.
  635.  
  636.         FFF also has an expanded wild card search algorithm. If you include an
  637.         *  on both sides  of the  filename, FFF will  find all  files that
  638.         contain  the  characters  entered  between  the  *'s  anywhere  in the
  639.         filename. For example:
  640.  
  641.         FFF *inst*
  642.  
  643.         This will find all files that contain inst somewhere in the filename.
  644.              I.E  D:\ANY\PINST.BAT
  645.                   C:\ONE\PCINSTAL.BAT
  646.                   C:\TWO\INSTALL.COM
  647.  
  648.         To  find  files with  no  extension include  the  period  but no  file
  649.         extension. I.E.  FFF *me*.
  650.  
  651.         If no  disk or directory is  included with the filespec  than all hard
  652.         disks will be searched.
  653.  
  654.         FFF now has the capability to automatically identify all hard disks on
  655.         your  system.  You  can over-ride this  automatic detection by setting
  656.         the environment variable FF to the disk letter your wish the search to
  657.         be performed on.
  658.  
  659.         For example.  SET FF=CD tells FFF to search the C and D drives if  you
  660.         have not specified a disk in the filespec on the command line.
  661.  
  662.  
  663.         FFF will display  all the files it found, up  to it's internal maximum
  664.         of 3000 files, on the screen in a scrollable list.  You can use the
  665.         cursor  keys, Pgup, Pgdn,  HOME, END, CTL-HOME,  and CTL-END to scroll
  666.         the list.  Pressing the ESC key will exit the program.
  667.  
  668.  
  669.  
  670.                           FileFinder Version 4.5 User Manual          Page-17-
  671.  
  672.                                      FFF HOT KEYS
  673.  
  674.         ALT-X
  675.         ALT-Q
  676.         ESC  Any of these keys will immediately exit FFF.
  677.  
  678.         CURSOR-RIGHT
  679.         CURSOR-LEFT
  680.              Scroll screen right or left.
  681.  
  682.         HOME Pressed  once will take you to  top of screen. Pressed twice will
  683.         take you to top of list.
  684.  
  685.         END  Pressed  once will take  you to  bottom of screen.  Pressed twice
  686.              will take you to bottom of list.
  687.  
  688.         F1   will display the help panel.
  689.  
  690.         F9   This will  allow you to sort  the file list that  is displayed on
  691.              the screen.  The list can  be sorted by filename, file extension,
  692.              file date, or disk:\dir location.
  693.  
  694.         ENTER
  695.              Pressing the ENTER will do  one of three things depending  on how
  696.              the ENTER key was configured.
  697.  
  698.              1) The ENTER key will do nothing.
  699.  
  700.              2) The  ENTER key will exit  the FFF program and  will change the
  701.              default disk  and directory  to the one   that contains  the file
  702.              currently highlighted on the screen.
  703.  
  704.              3) The  ENTER key will  invoke the SHEZ program  on the currently
  705.              highlighted file.
  706.  
  707.         CTRL-ENTER
  708.  
  709.              The CTRL-ENTER key invokes the SMART LAUNCH feature  of FFF.  FFF
  710.              looks at the file extension of the currently highlighted file and
  711.              execute the program that is associated with  that extension.  The
  712.              associations are  defined during  the  configuration of  the  FFF
  713.              program.   Before the  program is  launched, FFF will  attempt to
  714.              swap  itself out  of memory  if the  memory swapping  feature was
  715.              selected during program configuration.
  716.              If no smart launch program has been defined FFF will than  launch
  717.              the default BROWSE program.
  718.  
  719.         G    Pressing the G key will exit the FFF program and  will change the
  720.              default  disk and directory  to the one   that  contains the file
  721.              currently highlighted on the screen.
  722.  
  723.              (THE ENTER KEY WILL ONLY FUNCTION IF  THE USER SPECIFICALLY TELLS
  724.              THE FFFCFG PROGRAM TO ACTIVATE THE ENTER KEY.)
  725.  
  726.         R    Pressing the R key allows you to run any program you wish against
  727.              the  currently highlighted file.   A window  will pop-up in which
  728.              you must  enter program  name  that you  wish  to execute.    The
  729.              program  can be a DOS internal program,  i.e. del, rename, or any
  730.              EXE, COM,  or BAT file. When you enter the program to execute you
  731.  
  732.  
  733.  
  734.                           FileFinder Version 4.5 User Manual          Page-18-
  735.  
  736.              must  tell FFF  where to  place the  highlighted filename  in the
  737.              command by using the !  character as a place holder.   Before FFF
  738.              runs the command  the !  will be replaced  with  the  highlighted
  739.              filename.
  740.  
  741.         S    Pressing the S key will invoke my  Compressed file manager called
  742.              SHEZ. The Program file SHEZ.EXE must  be in the DOS path for this
  743.              options to function.
  744.  
  745.         E    Pressing the E key will execute the program or BAT file currently
  746.              highlighted on  the screen.  Before the  Program is  executed FFF
  747.              will prompt you for any command line parameters that you want  to
  748.              pass  to  the  program.  It will  then  change  to  the disk  and
  749.              directory  that the program  is contained in,  unload itself from
  750.              memory and execute the program.
  751.  
  752.         T    The T key will toggle the tagged status of the highlighted item.
  753.  
  754.         U    The U key will untag all tagged items.
  755.  
  756.         ALT-D     will delete the currently highlighted file.
  757.  
  758.         ALT-L     The ALT-L  key  will  invoke  the  browser  program  on  the
  759.                   highlighted  file.  The  BRZ.COM program must  be in the DOS
  760.                   path for this option to function.
  761.  
  762.         ALT-E     The  ALT-E key  will invoke  an editor  of your  choice. The
  763.                   default editor is QEdit  by Sammy Mitchell, however you  can
  764.                   change this default by using the FFFCFG program.
  765.  
  766.         ALT-C
  767.         ALT-O     The  ALT-O  or  ALT-C  keys  will  allow  you  to  copy  the
  768.                   highlighted file.   A window will  appear prompting you  for
  769.                   the destination drive and directory.
  770.  
  771.         ALT-W     The ALT-W key will invoke  a word processor of your  choice.
  772.                   The wordprocessor  program name must be set using the FFFCFG
  773.                   program before this options can be used.
  774.  
  775.         ALT-T     Write out the displayed file list to the file FFF.LST.
  776.              (Also see section titled: MODIFYING THE FFF FILE LISTING FORMAT)
  777.  
  778.         ALT-P     Print out the displayed file list to user specified device.
  779.              (Also see section titled: MODIFYING THE FFF PRINT FORMAT)
  780.  
  781.         ALT-I     Display a  windows containing configuration  and file  stats
  782.         information.
  783.  
  784.         ALT-S     Shell to DOS
  785.  
  786.         CTL-D     will delete all tagged files.
  787.  
  788.         CTL-C
  789.         CTL-O     The  CTL-O  or CTL-C  keys will  allow you  to copy  the all
  790.                   tagged  files.  A  window will appear  prompting you for the
  791.                   destination drive and directory.
  792.  
  793.         CTL-R     Pressing  the CTL-R key  allows you  to run any  program you
  794.                   wish  against all  tagged files.   A  window will  pop-up in
  795.  
  796.  
  797.  
  798.                           FileFinder Version 4.5 User Manual          Page-19-
  799.  
  800.                   which you must enter  program name that you wish to execute.
  801.                   The program can be a DOS internal program, i.e. del, rename,
  802.                   or any EXE, COM, or BAT file.  When you enter the program to
  803.                   execute you must tell FFF where to place the tagged filename
  804.                   in the command by using  the ! character as a place  holder.
  805.                   Before FFF runs the command the ! will be replaced  with the
  806.                   filename.
  807.  
  808.         CTL-T     Write out a list of all tagged files to file FFF.LST.
  809.  
  810.         CTL-P     Print out a list of all tagged files to device STDPRN.
  811.  
  812.         CTL-G     Pressing the CTL-G keys will  allow you to run the  included
  813.                   SGREP  program against a  group of  tagged files.   (See the
  814.                   section titled SGREP PROGRAM for more information)  You will
  815.                   have  the option  of performing  a normal  text search  or a
  816.                   regular expression search against all tagged files.
  817.  
  818.         /    Pressing the forward slash key will activate the FFF menu system.
  819.              A menu bar will appear at the top of the screen.  Using the left,
  820.              right, up, and down cursor keys highlight  the menu item you wish
  821.              to activate then press the  ENTER key to perform the  highlighted
  822.              operations.  Pressing the ESC key will exit the menu system.
  823.  
  824.         CAPS-LOCK
  825.              When the CAPS-LOCK key is active,  a tagged file status line will
  826.              be displayed on the bottom of the screen.  Pressing the CAPS-LOCK
  827.              key again will remove this status line.
  828.  
  829.         ALT-F2
  830.              The ALT-F2 keys allows the user  to modify the format of the file
  831.              list that is written out when the ALT-T keys are pressed.
  832.  
  833.         ALT-F3
  834.         ALT-F4
  835.              The ALT-F3 and ALT-F4  keys allows the user  to modify the  print
  836.              format when  the ALT-P keys are  pressed.  The ALT-F3  key allows
  837.              you to edit print  line 1 format.  The ALT-F4 keys allows your to
  838.              edit the print line2 format.
  839.  
  840.         ALT-F5
  841.              The ALT-F5 keys  allows the use to change the  default print line
  842.              length.
  843.  
  844.  
  845.                           FileFinder Version 4.5 User Manual          Page-20-
  846.  
  847.                         MODIFYING THE FFF FILE LISTING FORMAT
  848.  
  849.         When writing out a file list using the ALT-T keys, FFF uses a template
  850.         that defines the format of the  file.  The template contains variables
  851.         that tells FFF what information  to include in the file listing.   The
  852.         following variables can be used when defining the template:
  853.  
  854.         VARIABLE  DESCRIPTION              LENGTH
  855.         $FF  =    filename.file-extension       12 characters
  856.         $FN  =    filename            variable
  857.         $FX  =    file-extension           variable
  858.         $N8  =    filename            8 characters
  859.         $X3  =    file-extension           3 characters
  860.         $DN  =    directory-name           variable
  861.         $DF  =    directory-name           80 characters
  862.         $CN  =    full-path-specification       variable
  863.         $SZ  =    file-size                8 characters
  864.         $DT  =    file-date           8 characters
  865.         $TI  =    file-time           8 characters
  866.         $AT  =    file-attributes               4 characters
  867.  
  868.         The default format when writing out a file listing is:
  869.         $SZ $DT $TI $AT $CN
  870.  
  871.         Using the ALT-F2 command the format of the listing file can be changed
  872.         while  FFF is currently  being executed.   When modifying the template
  873.         please be aware that anything entered on the  template line other than
  874.         a  variable name  will also  appear in  the file  listing file.   THIS
  875.         INCLUDED BLANK CHARACTERS.
  876.  
  877.         The  default may  also  be changed  by using  the  FFFCFG program  and
  878.         modifying the listing template when then appropriate prompt appears.
  879.  
  880.  
  881.                           FileFinder Version 4.5 User Manual          Page-21-
  882.  
  883.                             MODIFYING THE FFF PRINT FORMAT
  884.  
  885.         When printing out a file list using the ALT-P keys, FFF uses a
  886.         template that defines the format of the file.  The template contains
  887.         variables that tells FFF what information to include in the printer
  888.         listing.  The following variables can be used when defining the
  889.         template:
  890.  
  891.         VARIABLE  DESCRIPTION              LENGTH
  892.         $FF  =    filename.file-extension       12 characters
  893.         $FN  =    filename            variable
  894.         $FX  =    file-extension           variable
  895.         $N8  =    filename            8 characters
  896.         $X3  =    file-extension           3 characters
  897.         $DN  =    directory-name           variable
  898.         $DF  =    directory-name           80 characters
  899.         $CN  =    full-path-specification       variable
  900.         $SZ  =    file-size                8 characters
  901.         $DT  =    file-date           8 characters
  902.         $TI  =    file-time           8 characters
  903.         $AT  =    file-attributes               4 characters
  904.  
  905.         The default format when printing out a file listing is two lines per
  906.         file. Their format is as follows.
  907.         $CN
  908.         $SZ $DT $TI $AT
  909.  
  910.         Using the ALT-F3 and ALT-F4 commands the format of print line one and
  911.         print line two can be changed while FFF is currently being executed.
  912.         If you do not want two print lines produced per file set the second
  913.         print line template to all blanks via the ALT-F4 command or set the
  914.         second print line template to all blanks when using the FFFCFG program
  915.         to configure the FFF program. When modifying the template please be
  916.         aware that anything entered on the template line other than a variable
  917.         name will also appear in the file listing file.  THIS INCLUDED BLANK
  918.         CHARACTERS.
  919.  
  920.         The default may also be changed by using the FFFCFG program and
  921.         modifying the print line templates when then appropriate prompt
  922.         appears.
  923.  
  924.  
  925.                           FileFinder Version 4.5 User Manual          Page-22-
  926.  
  927.                                      FFD PROGRAM
  928.  
  929.         This  program will find directories on  your hard disk(s), and present
  930.         them in a scrollable list.
  931.  
  932.         Format is FFD [options] [[drives:] [filespec]] [options]
  933.  
  934.         Where options are:
  935.         /2   25 line mode display
  936.         /4   43 line mode display
  937.         /5   50 line mode display
  938.         /G   Greater or Equal to mm-dd-yy
  939.         /=   Equal to mm-dd-yy
  940.         /L   Less or Equal to mm-dd-yy
  941.         /Z[RHSA]
  942.              Show files with specified attributes
  943.         /LN  Look for network drives
  944.         /@   Prompt for options.
  945.         /!   Exclude directories that match specified pattern.
  946.  
  947.         /G   This option  allows you to  limit the file  search to files  that
  948.              have a filedate  Greater than or Equal to the date specified. The
  949.              format is /Gmm-dd-yy.
  950.              I.E.  /G01-01-90   or    /G1-1-90  will list  files  that  have a
  951.         filedate greater than or equal to 1-1-90.
  952.              (Note this option may be combined with the /L option to specify a
  953.         date range)
  954.  
  955.         /L   This option  allows you to  limit the  file search to  files that
  956.              have  a filedate Less  than or Equal  to the  date specified. The
  957.              format is /Lmm-dd-yy.
  958.              I.E. /L01-01-90    or   /L1-1-90  will  list files  that  have  a
  959.              filedate less than or equal to 1-1-90.
  960.              (Note this option may be combined with the /G option to specify a
  961.         date range)
  962.  
  963.         /=   This  option allows you  to limit the  file search to  files that
  964.              have a  filedate Equal to the date specified. The format is /=mm-
  965.              dd-yy.
  966.              I.E.  /=01-01-90   or    /=1-1-90 will  list  files  that have  a
  967.              filedate to 1-1-90.
  968.  
  969.         /Z[RHSA]
  970.              This option  allows you  to limit the  file search to  files that
  971.              have specific attributes.  For example, specifying  /ZA will list
  972.              files that have  the archive attribute, /ZRH will list files that
  973.              have the read-only attribute OR the hidden attribute set.
  974.              **PLEASE NOTE IF YOU SPECIFY THE /A OR /I OPTION THAN THIS OPTION
  975.              IS IGNORED.**
  976.  
  977.         /LN  This option  allow you to search for files on Network drives.  If
  978.              you  configured FF2  to ignore  network drives  you may  use this
  979.              options to temporarily look for files on any networked drives.
  980.  
  981.         /!   This option  allows you to exclude  directories. Directories that
  982.              match the  excluded pattern will not  be listed.  For  example if
  983.              you entered the following command:
  984.              FF2  * /!f*
  985.              This would list all the dirs  EXCEPT for dirs that begin with the
  986.  
  987.  
  988.  
  989.                           FileFinder Version 4.5 User Manual          Page-23-
  990.  
  991.              letter F..
  992.  
  993.  
  994.         /@   This  options instructs FFD  to prompt  the user for  the command
  995.              line parameters. PLEASE  NOTE NO OTHER PARAMETERS ARE  ALLOWED ON
  996.              THE COMMAND  LINE IF THIS OPTION  IS SPECIFIED.  The  use of this
  997.              option  also allows the user  to use the  DOS redirect feature to
  998.              feed FF2 it's parameters.
  999.  
  1000.              For example:  FFD /@ < FFD.DAT
  1001.  
  1002.              This  instructs FFD to  read its  parameters from the  file names
  1003.         FFD.DAT.
  1004.  
  1005.  
  1006.                           FileFinder Version 4.5 User Manual          Page-24-
  1007.  
  1008.                                      FFD HOT KEYS
  1009.  
  1010.         ALT-X
  1011.         ALT-Q
  1012.         ESC  Any of these keys will immediately exit FFF.
  1013.  
  1014.         CURSOR-RIGHT
  1015.         CURSOR-LEFT
  1016.              Scroll screen right or left.
  1017.  
  1018.         HOME Pressed  once will take you to  top of screen. Pressed twice will
  1019.         take you to top of list.
  1020.  
  1021.         END  Pressed  once will take  you to  bottom of screen.  Pressed twice
  1022.              will take you to bottom of list.
  1023.  
  1024.         F1   will display the help panel.
  1025.  
  1026.         F9   This will  allow you to sort  the file list that  is displayed on
  1027.              the screen.  The list can  be sorted by filename, file extension,
  1028.              file date, or disk:\dir location.
  1029.  
  1030.         ENTER
  1031.              Pressing the  ENTER  key will  run the  FFF  program against  the
  1032.         currently highlighted directory.
  1033.  
  1034.  
  1035.         G    Pressing the  G key will exit the FFD program and will change the
  1036.              default disk and directory to the one currently highlighted.
  1037.  
  1038.  
  1039.         ALT-I     Display a windows containing FFF stats and information.
  1040.  
  1041.         ALT-S     Shell to DOS.
  1042.  
  1043.         DEL  will delete all tagged files.
  1044.  
  1045.         ALT-T     Write out directory list to file FFD.LST
  1046.  
  1047.  
  1048.                           FileFinder Version 4.5 User Manual          Page-25-
  1049.  
  1050.  
  1051.                                  SMART LAUNCH FEATURE
  1052.  
  1053.         The SMART LAUNCH  feature of FFF allows FFF to  execute a user defined
  1054.         program based on the file extension of the currently highlighted file.
  1055.         The FFFCFG  program allows you to enter  three sets of file extensions
  1056.         and three associated programs to launch when the CTRL-ENTER is pressed
  1057.         in the FFF program.
  1058.         The FFFCFG program will display the following prompts:
  1059.  
  1060.         ENTER/EDIT FILE EXTENSION LIST 1:
  1061.         EXT->
  1062.  
  1063.         AT this prompt enter the  first list of file extensions that  you wish
  1064.         the FFF program to identify.  The list must include  the dot extension
  1065.         separator and there may NOT be and spaces in  the list.  If you wanted
  1066.         FFF to identify  the following file  extensions, C, H,  CPP, INC,  the
  1067.         list would be entered as follows:
  1068.         .C.H.CPP.INC
  1069.  
  1070.         ENTER/EDIT PROGRAM FOR EXTENSION LIST 1:
  1071.         PGM->
  1072.  
  1073.         At this  prompt enter the full path name of  the program that you want
  1074.         FFF to  launch if the  highlighted file has  a file extension  that is
  1075.         included in list number 1.
  1076.  
  1077.         i.e.  PGM->C:\UTILITY\EDIT.EXE !
  1078.  
  1079.         NOTE THE  ! CHARACTER.   THIS CHARACTER  INDICATES TO THE  FFF PROGRAM
  1080.         WHERE TO PLACE  THE FILENAME WHEN LAUNCHING THE PROGRAM.   Through the
  1081.         use of  this character the user can also place any needed command line
  1082.         switches in the PGM specification.
  1083.  
  1084.  
  1085.                             MEMORY SWAPPING OPTION IN FFF
  1086.         Beginning  with release  3.3  of the  FFF program,  a  memory swapping
  1087.         ability  has been added.  When invoking  the Editor, SHEZ, shelling to
  1088.         DOS, or invoking another program via the R or CTL-R functions, FFF can
  1089.         optionally swap  90% of  its code  to either XMS,  EMS memory  (3.0 or
  1090.         4.0), or to disk if XMS or  EMS memory is not available.  This  option
  1091.         is  OFF  by  default.   It  can  be  turned  on by  using  the  FFFCFG
  1092.         configuration  program.   Using  this option  allows you  to  run much
  1093.         larger programs from within FFF than  would be normally possible.  FFF
  1094.         first tries XMS memory than EMS memory.
  1095.  
  1096.  
  1097.                                  MONOCHROME MONITORS
  1098.  
  1099.         If you are using a  monochrome monitor and the screen does  not appear
  1100.         correct set the environment variable MONO to a Y.  I.E. SET MONO=Y.
  1101.  
  1102.                                   MISC. INFORMATION
  1103.  
  1104.         Both FF2 and FFF are both DesQview aware.
  1105.         Beginning with  version 3.4  both FF2  and FFF  will  now also  search
  1106.         directories that have hidden or system  attributes associated with the
  1107.  
  1108.  
  1109.  
  1110.                           FileFinder Version 4.5 User Manual          Page-26-
  1111.  
  1112.         directory.
  1113.  
  1114.  
  1115.                           FileFinder Version 4.5 User Manual          Page-27-
  1116.  
  1117.                                   THE SGREP PROGRAM
  1118.  
  1119.         The SGREP program, supplied with SHEZ, is used by SHEZ when the ALT-G
  1120.         key is pressed, to scan member(s) of a compressed file for words or
  1121.         phrases.  It is included in the SHEZ package for those user's that do
  1122.         not have the FGREP program written by Chris Dunford.  While the SGREP
  1123.         program performs the same function, it is not as fast or as powerful
  1124.         as Chris Dunford's FGREP program.  When the ALT-G keys are pressed,
  1125.         SHEZ first tries to locate the SGREP.COM program,  if it can not be
  1126.         found SHEZ will than try to locate the FGREP.COM program.  Which ever
  1127.         program is found will be the one SHEZ users to scan for text.
  1128.  
  1129.         The SGREP command line format uses a subset of the FGREP program to
  1130.         maintain compatibility with FGREP.  SGREP does allow the user to
  1131.         specify two target strings in the search argument.  These two target
  1132.         strings are connected with an and, &, or or, '|' separator.  Thus
  1133.         allowing the user to search for two different strings, or two strings
  1134.         or words contained on the same line.  When the specific string is
  1135.         found, the line in the file that contains the string is written to the
  1136.         stdout DOS device, which is normally the display.  The output may be
  1137.         redirected to a file or a printer using the normal DOS redirection
  1138.         symbols.  The format of the SGREP command line is as follows:
  1139.  
  1140.         SGREP [options] "target(s)" {file(s)...|@file}
  1141.  
  1142.         Where options are:
  1143.  
  1144.              -f   display **FILE-NAME for finds only
  1145.              -l   line numbers
  1146.              -c   case sensitive search
  1147.              -x   no logo
  1148.              -e   return errorlevel only
  1149.              -p   pause when screen is full
  1150.              -v   verbose display output
  1151.              -r   perform a regular expression search
  1152.  
  1153.         @file indicates an ascii file containing a list of file to process.
  1154.         This list MUST include the complete file specification.  I.E. The
  1155.         disk, directory, filename, and file extension.
  1156.  
  1157.         The target string(s) must be enclosed in quotes and special characters
  1158.         can be specified as indicated below.
  1159.  
  1160.         Hex byte sequences can be used to search for special non-displayable
  1161.         characters.  They are specified using a pair of hexadecimal bytes
  1162.         preceded by a dollar sign,$.
  1163.  
  1164.         EXAMPLES: $23       include is the string #include
  1165.                   $252.50   is the string %2.50
  1166.                   $23$24$25 is the string #$%
  1167.  
  1168.         Two targets may be specified using the & and | characters to search
  1169.         for two targets.  If the & is used the lines must contain
  1170.         both targets.  If the | is used the lines must contain one of the
  1171.         targets.
  1172.  
  1173.         Example:  "save|main"    line must have save or main to be listed.
  1174.                   "save&main"    line must have save and main to be listed.
  1175.  
  1176.  
  1177.                           FileFinder Version 4.5 User Manual          Page-28-
  1178.  
  1179.         The format of the SGREP command line is presented here for
  1180.         documentation purposes only since FFF automatically invokes SGREP
  1181.         itself using a predefined set of options.  SGREP may be run from the
  1182.         DOS command prompt, or when using the CTRL-G command option of FFF.
  1183.  
  1184.  
  1185.  
  1186.                           FileFinder Version 4.5 User Manual          Page-29-
  1187.  
  1188.                                  REGULAR EXPRESSIONS
  1189.  
  1190.         The regular_expression defines the pattern to search for.  Upper- and
  1191.         lower-case are always ignored.  Blank lines never match.  The
  1192.         expression should be quoted to prevent file-name translation.
  1193.  
  1194.         x     An ordinary character (not mentioned below) matches that
  1195.              character.
  1196.         "\"  The backslash quotes any character.  "\$" matches a dollar-sign.
  1197.         "^"  A circumflex at the beginning of an expression matches the
  1198.              beginning of a line.
  1199.         "$"  A dollar-sign at the end of an expression matches the end of a
  1200.              line.
  1201.         "."  A period matches any character except "new-line".
  1202.         "*"  An expression followed by an asterisk matches zero or more
  1203.              occurrences of that expression: "fo*" matches "f", "fo"  "foo",
  1204.              etc.
  1205.         "+"  An expression followed by a plus sign matches one or more
  1206.              occurrences of that expression: "fo+" matches "fo", etc.
  1207.         "-"  An expression followed by a minus sign optionally matches the
  1208.              expression.
  1209.  
  1210.         "[]" A string enclosed in square brackets matches any character in
  1211.              that string, but no others.  If the first character in the string
  1212.              is a circumflex, the expression matches any character except
  1213.              "new-line" and the characters in the string.  For  example,
  1214.              "[xyz]" matches "xx" and "zyx", while "[^xyz]"      matches "abc"
  1215.              but not "axb".  A range of characters may be specified by two
  1216.              characters separated by "-".  Note that, [a-z] matches
  1217.              alphabetic, while [z-a] never matches.
  1218.  
  1219.  
  1220.                           FileFinder Version 4.5 User Manual          Page-30-
  1221.  
  1222.                                    REVISION HISTORY
  1223.  
  1224.  
  1225.         v4.6 5/18/94 Added /F fixed listing option to FF2 program.
  1226.              Added /D display compressed files being searched to FF2 program.
  1227.              Added /SL and /SG options to search for files based on file size.
  1228.              Fixed  screen problems when screen  is set to  mode that has more
  1229.              than 25 lines.
  1230.              Corrected  read ZIP  routine to prevent  machine lockup  when ZIP
  1231.              file is corrupt.
  1232.              FF2 and  FFF will now,  by default, also search  for files inside
  1233.              directories that contain filename extensions.
  1234.  
  1235.         v4.5 12/27/93  FFF will use EMS automatically if available for storing
  1236.              directory information.
  1237.              Added  /T command line  parameter to FF2 and  FFF program to find
  1238.              files that contain specified text strings.
  1239.              Added  /W command line parameter  to FF2 and  FFF program to find
  1240.              files created or modified on a specific day of the week.
  1241.              FFF, FF2 and FFD will now automatically bypass CD-ROM drives.
  1242.              Corrected screen scrolling problem in FF2.
  1243.              FFF, FF2, and FFD now  use a common external configuration  files
  1244.              that is created and maintained by the FFFCFG program.
  1245.              When  performing  a  search  on tagged  files  in  FFF  a regular
  1246.              expression search may now optionally be performed.
  1247.              The file viewing program BRZ is now included in the FFF package.
  1248.  
  1249.         v4.4 09/20/93 Increased file limit in FFF to 15,000 files.
  1250.              Added ability to print to a file or to LPT1-9.
  1251.              Gave user the ability to modify the format of a saved file list.
  1252.              Gave  user the  ability  to modify  the format  of  a print  file
  1253.              listing.
  1254.              Fixed problem with FFF not finding the last duplicate file.
  1255.              The FFD program will now show the root directory of all  included
  1256.              search drives.
  1257.              When writing a  file list  FFF will now  prompt to over-write  or
  1258.              append the file if the FFF.LST file already exists.
  1259.              Added the ALT-T command to the FFD program.
  1260.              Added the FFFHLP.COM program to reduce the memory requirements of
  1261.              the FFF program.
  1262.  
  1263.         v4.3 04/13/93 Added  ability to  exclude  user specified  drives  from
  1264.              being searched.
  1265.              Made correction to date/time sort.
  1266.              Added CTRL right and left cursor for faster screen scrolling.
  1267.              Made swapping type configurable.
  1268.              Fixed ALT-T command.
  1269.              Increased search speed by 15-20%.
  1270.              Increased sort speed by 20%.
  1271.              When checking  for duplicate  files  user can  optionally  search
  1272.              inside compressed files for dups.
  1273.              Added drop down menu to the FFF program.
  1274.              Added more configuable item to the FFF program.
  1275.              Added  new program  FFD that will  search for  directory spanning
  1276.              drives.
  1277.  
  1278.         v4.2 03/14/93  Maximum number of  files that  FFF can handle  has been
  1279.              increased to 10,000.
  1280.              Added command line option /! to exclude file during search.
  1281.  
  1282.  
  1283.  
  1284.                           FileFinder Version 4.5 User Manual          Page-31-
  1285.  
  1286.              Added command line option /= to search for file equal to a date.
  1287.              Enhanced the HOME and END keys in FFF.
  1288.              Corrected sorting  routine  when  sorting  by  filename  or  file
  1289.              extension.
  1290.              When  sorting by extension, files with equal extensions will also
  1291.              be sorted by filename.
  1292.              Added  support to  search for  files inside  SQZ type  compressed
  1293.              files.
  1294.  
  1295.         v4.1 11/9/92 Fixed  the FFF program  to correctly accept  command line
  1296.              options that  are  entered in  when  using  the /@  command  line
  1297.              switch.
  1298.              Added the ability to configure the function of the ENTER key.
  1299.              Added a smart launch feature to the FFF program that is activated
  1300.              via the CTRL-ENTER key combination.
  1301.  
  1302.         v3.8 4/1/92 Added  CAPS-LOCK  command in  FFF to  display tagged  file
  1303.              status.
  1304.              Increased speed of locating and identifying all hard drives.
  1305.              Added SGREP program to search for text within tagged files.
  1306.              Added ability to swap FFF program to XMS or EMS memory.
  1307.              Added scroll bars to FFF display.
  1308.              Added ALT-C command to copy single files.
  1309.              Added CTL-C command to copy tagged files.
  1310.              Added CTL-G  command  to run  SGREP program  against  a group  of
  1311.              tagged files.
  1312.  
  1313.         v3.7 7/19/91  Corrected FFF  processing when  searching for  all files
  1314.              when using the /i option.
  1315.              Changed  the  FFFCFG  program  to  retain  previously  configured
  1316.              colors.
  1317.              Added the ability to perform a fuzzy search.
  1318.              Added  a configurable option to  turn the file over-write warning
  1319.              message off when copying tagged files.
  1320.  
  1321.         V3.6 5/6/91 - Corrected floating tags.
  1322.              Added ALT-I to display config. and file stats.
  1323.              Implemented new sort routine to speed up file sorting.
  1324.              Added ALT-T, CTL-T commands to write out a file list.
  1325.              Added ALT-P, CTL-P commands to print out a file list.
  1326.              Added ability to configure FFF's colors.
  1327.              Added ALT-X, and ALT-Q to exit FFF.
  1328.              Added the ability to activate or deactivate the ENTER key.
  1329.              Added the ability to configure FFF to handle up to 9000 files and
  1330.              300 unique directory names.
  1331.              When  invoking  the  browse program  via  the  ALT-L  command, if
  1332.              swapping  is enabled FFF  will swap  itself out of  memory before
  1333.              invoking the browse program.
  1334.  
  1335.  
  1336.  
  1337.                           FileFinder Version 4.5 User Manual          Page-32-
  1338.  
  1339.  
  1340.                                         INDEX
  1341.  
  1342.  
  1343.         CONFIGURING THE FFF.EXE PROGRAM . . . . . . . . . . . . . . . . . .  5
  1344.  
  1345.  
  1346.         FF2 Command line options
  1347.  
  1348.              /! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1349.  
  1350.              /= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1351.  
  1352.              /@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1353.  
  1354.              /1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1355.  
  1356.              /A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1357.  
  1358.              /B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1359.  
  1360.              /C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1361.  
  1362.              /E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1363.  
  1364.              /G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1365.  
  1366.              /I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1367.  
  1368.              /L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1369.  
  1370.              /P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1371.  
  1372.              /Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1373.  
  1374.              /R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1375.  
  1376.              /S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1377.  
  1378.              /SD  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1379.  
  1380.  
  1381.         FFD Command line options
  1382.  
  1383.              /! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1384.  
  1385.              /= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1386.  
  1387.              /@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1388.  
  1389.              /2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1390.  
  1391.              /4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1392.  
  1393.              /5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1394.  
  1395.              /G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1396.  
  1397.              /L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1398.  
  1399.              /LN  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1400.  
  1401.              /Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1402.  
  1403.  
  1404.         FFD HOT KEYS  . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
  1405.  
  1406.  
  1407.         FFD PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1408.  
  1409.  
  1410.         FFF Command line options
  1411.  
  1412.              /! . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1413.  
  1414.              /= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1415.  
  1416.              /@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1417.  
  1418.              /2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1419.  
  1420.              /4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1421.  
  1422.              /5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1423.  
  1424.              /A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1425.  
  1426.              /d . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1427.  
  1428.              /E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1429.  
  1430.              /G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1431.  
  1432.              /I . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1433.  
  1434.              /L . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1435.  
  1436.              /SD  . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1437.  
  1438.              /Z[RHSA] . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1439.  
  1440.  
  1441.         FFF HOT KEYS  . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1442.  
  1443.  
  1444.         FFF PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1445.  
  1446.  
  1447.         MEMORY SWAPPING OPTION IN FFF . . . . . . . . . . . . . . . . . . . 25
  1448.  
  1449.  
  1450.         MEMORY USAGE IN THE FFF.EXE PROGRAM . . . . . . . . . . . . . . . .  6
  1451.  
  1452.  
  1453.         MODIFYING THE FFF FILE LISTING FORMAT . . . . . . . . . . . . . . . 20
  1454.  
  1455.  
  1456.         MODIFYING THE FFF PRINT FORMAT  . . . . . . . . . . . . . . . . . . 21
  1457.  
  1458.  
  1459.         MONOCHROME MONITORS . . . . . . . . . . . . . . . . . . . . . . . . 25
  1460.  
  1461.  
  1462.         PERFORMING A FUZZY SEARCH . . . . . . . . . . . . . . . . . . . . .  4
  1463.  
  1464.  
  1465.         QUICK START . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  1466.  
  1467.  
  1468.         REGULAR EXPRESSIONS . . . . . . . . . . . . . . . . . . . . . . . . 29
  1469.  
  1470.  
  1471.  
  1472.                           FileFinder Version 4.5 User Manual          Page-33-
  1473.  
  1474.  
  1475.         REVISION HISTORY  . . . . . . . . . . . . . . . . . . . . . . . . . 30
  1476.  
  1477.  
  1478.         SMART LAUNCH FEATURE  . . . . . . . . . . . . . . . . . . . . . . . 25
  1479.  
  1480.